Set up Cursor Cloud dev environment for Learning Lens - #1
Draft
moegon wants to merge 1 commit into
Draft
Conversation
Co-authored-by: MG <moegon@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sets up and verifies the Learning Lens development environment on the Linux cloud VM, and documents durable, non-obvious setup notes for future agents.
This PR only adds a
## Cursor Cloud specific instructionssection toAGENTS.md; no product code is changed. The environment tooling itself (uv/Python 3.13, Swift 6 toolchain) is captured in the VM snapshot and refreshed by the configured startup update script.Environment
The cloud VM is Linux (x86_64). Two of the three components run here; the SwiftUI app is macOS/Xcode-only.
uv+ a uv-managed Python 3.13 and syncedbackend/deps.swiftly(+ required system libs) so the sharedLearningLensCorepackage tests run on Linux.What I ran
backend/, FastAPI)uv run ruff check .— passeduv run pytest— 8 passedmake backend-run(uvicorn on :8000)LearningLensCore(Swift pkg)make swift-test— 5 passedapple/App)macos-15)make test(swift-test + backend-test) passes end-to-end on Linux: 5 + 8 tests.Hello-world verification
Started the backend and submitted a de-identified aggregate observation to
POST /v1/educator-insights, which returned a bounded, non-diagnostic educator summary (provider: local) with next steps and a safety notice. Also confirmed the privacy safety-gate rejects diagnostic language with HTTP 422.learning_lens_backend_educator_insights_demo.mp4
Swagger UI loaded for Learning Lens API
Startup update script
$HOME/.local/bin/uv sync --all-groups --project backend— minimal backend dependency refresh (the Swift package has no external deps, so nothing to re-sync there).To show artifacts inline, enable in settings.